home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / libs / bignum_37_28.lha / BigNum / BigNum.doc
Text File  |  1997-02-12  |  3KB  |  87 lines
  1.  ___ _                       _ _ _                      
  2. | _ |_)__ _ _ _ _  _ _ __   | (_) |__ _ _ __ _ _ _ _  _ 
  3. | _ \ / _` | ' \ || | '  \  | | | '_ \ '_/ _` | '_| || |
  4. |___/_\__, |_||_\_,_|_|_|_| |_|_|_.__/_| \__,_|_|  \_, |
  5.       |___/  © Allenbrand Brice                    |__/ 37.28
  6.  
  7. ----------------------------------------------------------------------
  8.  
  9.                    THE multiprecision integer library !
  10.  
  11. This library is EMailWare
  12. EMail: allenbrand@nucleus.fr
  13.  
  14. If you have suggestions I'd be happy to answer them.
  15.  
  16. ----------------------------------------------------------------------
  17.  
  18. This package contains the library and the protos for C programming.
  19. YOU MUST HAVE AT LEAST A 68020 AND ENOUGH RAM OR THE LIBRARY WON'T OPEN !!
  20.  
  21. *)BigNum.library  has  been  written using SAS/6.57.  It takes advantage of
  22. the Amiga system for maximum efficiency.
  23.  
  24. *)All overflows or division by 0 are managed by the library. (Hope so...)
  25.  
  26. *)It is easy to Use (yes yes)
  27.  
  28. *)No Enforcer hits (sure)
  29.  
  30. ----------------------------------------------------------------------
  31.  
  32. Now there are two versions :
  33.  
  34. Big
  35. ---
  36.  
  37. *)A BigNum is limited to 450000 digits and the library will need 10 Mo RAM
  38.  
  39. *)The  library  will manage 50 BigNums at a time.  All the allocations are
  40. made during the opening of the library for speed-up efficiency.
  41.  
  42. Small
  43. -----
  44.  
  45. *)A BigNum is limited to 130000 digits and the library will need 3 Mo RAM
  46.  
  47. *)The  library  will manage 50 BigNums at a time.  All the allocations are
  48. made during the opening of the library for speed-up efficiency.
  49.  
  50. ----------------------------------------------------------------------
  51.  
  52. USAGE :
  53.  
  54. 1) #include <proto/BigNum.h>
  55.  
  56. 2) struct Library *BigNumBase;
  57.  
  58. 3) At first, open the library with the common way.
  59.  
  60. 4) Then declare your BigNum : PtrBigNum x,y,z,u,i,op......
  61.  
  62. 5) Then INITIALIZE THEM : x=BigNumInit();y=BigNumInit()....
  63.  
  64. 6) Make your computations......
  65.    .....
  66.      ......
  67.          .....
  68. 7) After using, FREE THEM or you'll have warning message when you close
  69.    the library. If you forget it, this won't crash the machine or lose
  70.    memory, but it is an efficient way to know what if what you've done is
  71.    right
  72.    e.g if you Init 5 BigNums then call BigNumFree(5);
  73.  
  74. 8) Close the library or you'll lose memory.
  75.  
  76. Have a look at examples....
  77.  
  78. ----------------------------------------------------------------------
  79.  
  80. What's New :
  81.  
  82. AmigaGuide documentation
  83. No more 040 and 060 versions.
  84. Tiny bug removed.
  85. Enabled fast code for multiplication.
  86. Added BigNumSquare
  87.